Skip to content

feat(shir): governed SHIR chain as AgentPlane job v0.1#293

Open
mdheller wants to merge 6 commits into
mainfrom
feat/shir-governed-chain-job
Open

feat(shir): governed SHIR chain as AgentPlane job v0.1#293
mdheller wants to merge 6 commits into
mainfrom
feat/shir-governed-chain-job

Conversation

@mdheller

Copy link
Copy Markdown
Member

Summary

  • SHIRGovernedChainJob schema: AgentPlane job contract for shir.governed_chain.v0.1 — orchestrates rdf-to-shir → shir-to-pyg → semantic-leakage → chain receipt with explicit stage status tracking, 11 artifact refs, 8 failure modes, and policy_mode (advisory/fail_closed/review_required)
  • Conditional: job_status=requires_review|failed_closed requires failure_mode + policy_outcome; fail_closed policy_mode + semantic_leakage_blocking forces failed_closed status; shir_to_pyg completed must emit projection_loss_report_ref
  • No PyTorch/PyG/DGL runtime required in v0.1; no tensor materialization, no GNN training, no ontology promotion

Test plan

  • make validate-shir-governed-chain-job — PASS (2 valid, 2 reject)
  • Valid clean TopoLVM run: all 4 stages completed, 11 artifacts present, policy_outcome=allowed
  • Valid leakage review_required: semantic_leakage blocked, failure_mode=semantic_leakage_blocking, partial artifact retention
  • Reject: job_type const violation (v0.2)
  • Reject: requires_review without failure_mode + policy_outcome (schema conditional)

Closes #112
Upstream: mlops-ts-suite#36, #37, #38, #39, #45, #46

mdheller added 6 commits June 11, 2026 20:43
…del civic architecture (#154)

- CivicStackRunCapsule schema: run_id, actor_ref, oql_plan_id, artifact_manifest_id,
  policy_decision_id, tool_grants, action_dispatch_records, oql_plan_acceptance,
  oac_compiler_invocation, subagent_delegations, attestation_events, rationalgrl_trace,
  hellgraph_evidence_refs, delivery_excellence_signal_ref, provenance_refs, timestamps
- RationalGRL trace: goals_addressed (goal/softgoal), tasks_executed, dependencies_blocked
  with defeater_reason on blocked tasks and denied goals
- OQL plan acceptance with OQL-to-agent-task mappings
- OAC compiler invocation with artifact emission refs
- Policy gates: deny outcome enforces empty tool_grants + all dispatches blocked;
  blocked dispatches require defeater_reason; oac failure forbids artifact_emission_refs
- 2 valid fixtures (allow + deny/policy-blocked) + 3 reject fixtures
- validate-civic-stack-runtime-evidence wired into Makefile aggregate validate target
- Upstream anchors: ontogenesis#80, #81, policy-fabric#72, sociosphere#323, delivery-excellence#28
…sational services (#149)

- ConversationalActionEvidence schema: binds conversation session/turn to AgentPlane
  execution artifact — action_type (8-value enum), policy_decision_ref, execution_artifact_ref,
  replay_linkage (eligible/verified/divergence_detected/scope), hellgraph_evidence_refs
- ConversationalReplayRecord schema: replay artifact for conversational triggers — status
  (completed/failed/diverged/pending), replay_scope (turn/session/execution_artifact),
  divergence_record (conditional required when status=diverged) with divergence_type
  and resolution_status enums, non_claims required
- Policy gates: approval_denial forces deny/escalate outcome; replay_divergence_detected
  requires replay_divergence_ref; diverged status requires divergence_record
- 4 valid fixtures (trigger-execution, approval-denial, replay-completed, replay-diverged)
  + 2 reject fixtures
- validate-conversational-evidence wired into Makefile aggregate validate target
…cybernetic oversteer controls (#136)

- docs/doctrine/tensegrity-runtime-contract.md: compression members (agent/tool/service/model/repo/host)
  vs tension members (policy/identity/provenance/tests/signatures/audits/ledgers/capability_grants/replay/revocation)
  and five tensegrity invariants: policy always required, closed chain, revocation dissolves immediately,
  replay seals the loop, oversteer is a governance obligation
- docs/specs/agent-action-tension-members-v0.md: tension member obligations matrix by action type;
  structural rules (policy always required, replay for mutation actions, audit for blocked/intervention,
  revocation path at R2+, provenance must include upstream anchor)
- docs/specs/capability-radius-v0.md: R0 observe-local through R5 deployment-host-mutation;
  radius/tool-grant contract; rapid_radius_escalation oversteer indicator
- docs/specs/cybernetic-oversteer-v0.md: 10 oversteer indicators with tension member under strain mapping;
  detection contract (HellGraph emission, delivery_excellence degraded, escalate elevation, RationalGRL softgoal);
  oversteer vs. error distinction
- examples/tensegrity/agent-action-tension-members.example.json: full tension member declaration for R3 write
- examples/reachability/agent-capability-radius.example.json: R3 actor profile with conditional R4 gate
- examples/governance/oversteer-indicators.example.json: policy_flip_flops + repeated_failed_validations
  simultaneous firing → escalate elevation + delivery excellence degraded signal
…with replay semantics (#134)

- ConceptToArtifactLineageReceipt schema: concept_kind (10-value enum: term/definition/geometry_relation/
  projection_relation/scenario/prototype/artifact/commons_impact_claim/dymaxion_metric_claim/cross_reference),
  source_anchor (type/confidence/assumptions), geometry_projection with mandatory distortion_assumptions,
  artifact_linkage with lineage_chain_refs, commons_impact with evidence_basis enum,
  dymaxion_metric with required assumptions
- extraction_mode 4-value enum: deterministic_extraction → exact replay; model_assisted → near_equivalent;
  human_review → indicative_only; non_replayable_interpretive_judgment → not_replayable
- Policy gates: non_replayable mode forces is_replayable=false + non_replayable_reason required;
  distortion_assumptions and dymaxion_metric.assumptions must be non-empty; asserted_without_evidence
  commons claims cannot be peer_reviewed; non_claims required on all receipts
- 3 valid fixtures: Dymaxion artifact lineage (model_assisted), geodesic projection claim (human_review),
  interpretive judgment (non_replayable) + 2 reject fixtures
- validate-concept-to-artifact-lineage wired into Makefile aggregate validate target
- Integration targets: ontogenesis#61, gaia-world-model#21, sherlock-search#42, sociosphere#291
…ecution artifacts (#119)

- ModelRoutingLaneDecisionReceipt schema: run_ref, chain_stage (planning/execution/verification/
  reflection/synthesis), task_class (8 values), requested_lane, selected_lane (5 lanes: no_model through pro),
  lane_decision_outcome (lane_selected/downgraded/escalated/denied/deferred), cost_class, prompt_evidence_policy
  (hash_only default — raw prompts never stored), context_tool_posture, verification_mode
- High-end/pro conditional: selected_lane=high_end or pro requires escalation_receipt_ref +
  de_escalation_required_after_stage (schema conditional allOf)
- Policy gates: denied outcome must de-escalate to no_model; verification stage must not use
  model_primary; high-end without escalation_receipt → denied; no raw prompts enforced
- 4 valid fixtures: standard lane_selected, escalated high_end with receipt+de-escalation, verification
  no_model mechanical_tools_only, denied high_end without escalation de-escalated to no_model
- 2 reject fixtures
- validate-model-routing-lane-receipts wired into Makefile aggregate validate target
- Consumers: model-router (AgentExecutionModelRoutingPolicy), guardrail-fabric integration
- SHIRGovernedChainJob schema: job_type const (shir.governed_chain.v0.1), 4 required inputs
  (input_ref, schema_ref, ontology_profile_ref, out_ref), policy_mode (advisory/fail_closed/review_required),
  relation_strategy (default relation_node), all 4 stages (rdf_to_shir/shir_to_pyg/semantic_leakage/chain_receipt),
  full artifact manifest (11 artifact refs), 8 failure modes
- job_status conditional: requires_review/failed_closed require failure_mode + policy_outcome
- Policy gates: fail_closed + semantic_leakage_blocking → failed_closed; completed requires chain_receipt
  completed; shir_to_pyg completed requires projection_loss_report_ref
- 2 valid fixtures: clean TopoLVM run (allowed) + leakage review_required (semantic_leakage_blocking)
- 2 reject fixtures: wrong job_type const, requires_review without failure_mode
- validate-shir-governed-chain-job wired into Makefile aggregate validate target
- Non-goals enforced: no tensor materialization, no GNN training, no ontology promotion, no PyTorch/PyG/DGL
- Upstream: mlops-ts-suite#36-39, #45, #46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Orchestrate governed SHIR chain as AgentPlane job v0.1

1 participant